文档 / 模板开发

模板市集与上架

模板市集子平台(pa/templates)是模板的分发中心:所有应用可见/可安装任意模板,每个应用同一时间只有一个激活模板

生命周期

draft → submit → review → approved → (online)  ← 审核流
                 ↓ rejected
               draft(可修改再提交)

状态:draft 草稿 → review 待审 → approved 已通过(官方)→ offline 下架。

模板管理 API

# 创建模板
POST /templates/v1/templates
body: { code, name, category, version, template: {...}, seed: {...}, ... }

# 提交审核
POST /templates/v1/templates/{code}/submit

# 审核(运营)
POST /templates/v1/templates/{code}/approve   body: { verified: true }
POST /templates/v1/templates/{code}/reject    body: { comment }

# 公开市场列表(无需登录)
GET /templates/v1/templates?lang=cn&category=audio&free=1

安装 / 激活 / 回滚

# 安装到应用(预览态)
POST /templates/v1/templates/{code}/install   body: { appid }

# 激活(自动撤销该应用其他激活模板)
POST /templates/v1/templates/{code}/activate  body: { appid }

# 回滚到安装前
POST /templates/v1/templates/{code}/rollback  body: { appid }

安装时校验数据契约:

  • requires 里的 scope 目标应用必须已授权,否则返回 409 CONTRACT_UNSATISFIED
  • 安装 = 备份模板层配置 → 写 page_blocks/theme/settings → 预览 → 激活;
  • 数据层永不因切模板而变

提交一个好模板的检查清单

  • [ ] pages 至少一个页面,区块使用通用类型
  • [ ] requires 精确声明依赖 scope
  • [ ] 8 语言名称与描述齐全
  • [ ] 缩略图(thumbnail_url)与演示地址(demo_url)可用
  • [ ] seed 仅含演示数据,不预置正式内容
  • [ ] 价格合理(积分),免费模板建议 price=0